home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / QuickTime VR / MacOS / QuickDraw™ 3D 1.0.6F4 SDK / Development / 3DMF parser / 1.0 version / MF3DPC / !RELNOTE.TXT < prev    next >
Encoding:
Text File  |  1995-11-07  |  3.6 KB  |  75 lines  |  [TEXT/dosa]
  1. QuickDraw 3D Metafile Read/Write API Release Notes
  2.  
  3. ################################################################################
  4. # PC notes
  5. ################################################################################
  6.  
  7. The files for the PC version are in the folder MF3DPC. They are them same as
  8. the Mac versions, except that they have line feeds added and special characters
  9. removed.
  10.  
  11. This code has been tested using MSVC. Some metafiles will parse in the smaller
  12. memory models, but the large memory model is needed for larger files. Note that
  13. some files have too many objects or large objects that do not fit in a 64K
  14. pointer, and will fail to parse with an error 12002. It has not been tested
  15. with larger blocks on the PC, but it should work. MFMEMORY.C determines the
  16. largest block it can allocate.
  17.  
  18. To use this code on the PC, just add all the .C files except the sample code
  19. (MFEXAMPL.C) to your project. No special compiler options were used except
  20. the large memory model.
  21.  
  22. ################################################################################
  23. # Mac notes
  24. ################################################################################
  25.  
  26. The files for the Mac version are in the folder MF3DMac.
  27.  
  28. This code has been compiled under MPW and Metrowerks CodeWarrior 7. It should
  29. also work under THINK C and CW6. CodeWarrior's standard C library memory
  30. allocator causes problems with large 3DMF files (especially text) so MF3D now
  31. calls NewPtr directly when compiled under CodeWarrior. See MFMEMORY.C if you
  32. need to change this implementation.
  33.  
  34. All of the code is designed to allow use with normal 68K CODE segments.
  35. Segmentation has been performed. All the files are in segment __MF3D__ except
  36. for MFOBJECT.C which is broken into multiple segments. MFOBJECT.C may get split
  37. into multiple files in the future.
  38.  
  39. The MakeFile included in this release builds an MPW tool, but you can use the
  40. dependencies in your own makefile. To use MF3D under CodeWarrior, just drag all
  41. the .C files into your project. They can be in the same project segment since
  42. they are segmented internally. See the enclosed MF3D project for more info.
  43.  
  44. ################################################################################
  45. # Release #2
  46. ################################################################################
  47.  
  48. This release fixes a number of bugs, and adds PC compatibility to the parser.
  49.  
  50. Not all of the sample files listed in !README.TXT are included in this release.
  51. They will be added back into the next release.
  52.  
  53. The parser now handles all objects, even if it doesn't understand them. It 
  54. returns an object of type kMF3DObjUnknownType when an undefined object is
  55. encountered.
  56.  
  57. The code has been tested with a number of metafiles, and a few inconsistencies
  58. were uncovered. Some 'imcc' objects were found to have 16 bytes of data instead
  59. of 12 as described in the spec. 'fasl' and 'vasl' objects did not used the
  60. packed array as described in the spec. We will find the correct formats for
  61. objects and address these issues in the next release. Note that most 'fasl' and
  62. 'vasl' objects are not actually affected because most don't exclude/include
  63. specific items.
  64.  
  65. The parser does not read any file formats prior to 1.0.
  66.  
  67. Parsing is slow on text files that have large objects in them (such as meshes).
  68. The reason for this is known and will hopefully be addressed in the next
  69. release.
  70.  
  71. Bugs having to do with labels on the same line as groups have been fixed.
  72.  
  73. Bugs having to do with comments between a label and the corresponding object
  74. have been fixed.
  75.